};
```
-For GObject inheritence, we use the GObject.registerClass() function provided
+For GObject inheritance, we use the GObject.registerClass() function provided
by gjs.
```javascript
var MyActor = GObject.registerClass(
* Handle extension updates [Florian; !945]
* Animate showing and hiding caps-lock warning [Jonas; !952]
* Support "auto" lengths in CSS [Florian; !971]
-* Turn extension-prefs into the offical Extensions app [Florian; #1968]
+* Turn extension-prefs into the official Extensions app [Florian; #1968]
* Sandbox the portal helper [Michael; !983]
* Misc. bug fixes and cleanups [Florian, Björn, Jakub, Alexander, Daniel V.,
Jonas, nana-4, Carlos, Sebastian, Daniel G., Georges, Piotr; !918, !917,
======
* Fix keeping actors visible in scrollviews [Marco; #1061]
* Move some chrome above popup windows [Jonas D.; !358]
-* Include 'sandboxed-app-id' in winodw introspection info [Florian; #1289]
+* Include 'sandboxed-app-id' in window introspection info [Florian; #1289]
* Port to libecal-2.0 [Milan; !501]
* Support TCRYPT in mount password dialog [segfault; !126]
* Misc. bug fixes and cleanups [Florian, Marco, Veerasamy; !517, #745, !499,
* gdm: Fix "Not listed" focus indication [Florian; #784040]
* Fix missing icons in freedesktop notifications [Florian; #784245]
* gdm: Disable user list when empty [Xiaoguang; #731320]
-* gdm: Allow empty reponse to PAM messages [Ray; #784360]
+* gdm: Allow empty response to PAM messages [Ray; #784360]
* Fix blocked clicks in shutdown dialog [Florian; #781738]
* Show OSD popup when changing volume via scroll wheel [Florian; #781028]
* Refine list search results [Rares; #749957]
* Merge the wayland branch [Giovanni, Neil; #707467]
* Make search entry behave better in RTL locales [Matthias, Florian; #705779]
* Allow to change app pages with pageUp/pageDown keys [Carlos; #707979]
-* Set approriate a11y states on expandable menu items [Alejandro; #708038]
+* Set appropriate a11y states on expandable menu items [Alejandro; #708038]
* Improve page indicator animation [Carlos; #707565]
* Misc bug fixes and cleanups [Florian, Olivier, Jasper, Giovanni, Magdalen,
Adel, Carlos, Rico, Joanmarie; #707308, #707430, #707508, #707557, #707600,
* Update the calendar code to use ECalClient [Giovanni; #671177]
* Update jhbuild script to use the main moduleset [Owen, Will; #668440]
* StTextureCache: code cleanup, evict unused icons, merge together
- simulataneous requests for the same icon [Jasper; #670771, #671656, #672273]
+ simultaneous requests for the same icon [Jasper; #670771, #671656, #672273]
* Clean up St for recent Clutter changes and fix bugs. StContainer and
StGroup are removed [Jasper, Florian; #670034, #670640, #670904]
* Code cleanup [Adel, Jasper, Rui; #613194, #671086, #671103]
[Stefano; #664201]
- Delay rearranging windows in the overview as long as the pointer
is over a window [Vit; #645325]
-* Add a GConf => DConf migration file for overriden Mutter settings
+* Add a GConf => DConf migration file for overridden Mutter settings
[Florian; #667636]
* When a VPN connection is active, show that as the network icon
[Giovanni; #665115]
- Add fingerprint reader support [Ray; #657823]
- Add a power button offering the choice of Suspend/Restart/Power off
[Ray; #657822]
- - Remove the option to view the current keyboad layout [Matthias; #659164]
+ - Remove the option to view the current keyboard layout [Matthias; #659164]
- Make Control-Alt-Tab work for full keyboard access [Ray; #659177]
* Frequently initiate a full garbage collection; Spidermonkey isn't very good
at tracking the amount of resources we have allocated so this hopefully will
* Fix selection highlighting for light-on-dark entries [Jasper; #643768]
* Make control-Return in the overview open a new window [Maxim]
* Delay showing the alt-Tab switcher to reduce visual noise when
- flipping betweeen windows [Dan; #652346]
+ flipping between windows [Dan; #652346]
* When we have vertically stacked monitors, put the message tray
on the bottom one [Dan; #636963]
* Fix various problems with keynav and the Activities button
- Fix missing device descriptions with multiple devices of the
same type [Giovanni]
https://bugzilla.gnome.org/show_bug.cgi?id=646074
- - Label ad-hoc neworks with an appropriate icon [Dan]
+ - Label ad-hoc networks with an appropriate icon [Dan]
https://bugzilla.gnome.org/show_bug.cgi?id=646141
- Fix displaying some devices states as "invalid" [Dan]
https://bugzilla.gnome.org/show_bug.cgi?id=646946
if xkb:
return xkb
else:
- raise KeyError("layout %s explicitely disabled in overrides"
+ raise KeyError("layout %s explicitly disabled in overrides"
% locale)
xkb_names = sorted(name_to_xkb.keys())
if name in xkb_names:
@function draw_button_hilight_color($c) {
//
-// calculate the right top hilight color for buttons
+// calculate the right top highlight color for buttons
//
// $c: base color;
//
font-size: 18pt;
font-weight: 800;
- &.leightweight {
+ &.lightweight {
font-size: 13pt;
font-weight: 800;
}
-/* Notifications & Mesage Tray */
+/* Notifications & Message Tray */
$notification_banner_height: 64px;
$notification_banner_width: 34em;
-barlevel-overdrive-color: $destructive_color;
-barlevel-overdrive-border-color: if($variant == 'light', darken($destructive_color, 4%), lighten($destructive_color, 2%)); //trough border when red;
-barlevel-overdrive-separator-width:1px;
- // slider hander
+ // slider handler
-slider-handle-radius: $slider_size * 0.5; // half the size of the size
-slider-handle-border-width: 1px;
-slider-handle-border-color: if($variant == 'light', $borders_color, $fg_color);
let iconSpacing = labelNaturalHeight + iconPadding + iconBorder;
let totalSpacing = this._list.spacing * (this._items.length - 1);
- // We just assume the whole screen here due to weirdness happing with the passed width
+ // We just assume the whole screen here due to weirdness happening with the passed width
let primary = Main.layoutManager.primaryMonitor;
let parentPadding = this.get_parent().get_theme_node().get_horizontal_padding();
let availWidth = primary.width - parentPadding - this.get_theme_node().get_horizontal_padding();
this.add_approver_filter(filter);
this.add_handler_filter(filter);
- // Allow other clients (such as Empathy) to pre-empt our channels if
+ // Allow other clients (such as Empathy) to preempt our channels if
// needed
this.set_delegated_channels_callback(
this._delegatedChannelsCb.bind(this));
this._updateTitleStyleLater = Meta.later_add(Meta.LaterType.BEFORE_REDRAW, () => {
this._updateTitleStyleLater = 0;
- this._title.add_style_class_name('leightweight');
+ this._title.add_style_class_name('lightweight');
return GLib.SOURCE_REMOVE;
});
}
_setLabel(this._title, title);
- this._title.remove_style_class_name('leightweight');
+ this._title.remove_style_class_name('lightweight');
this._updateTitleStyle();
this.notify('title');
// When pageEmpty is received, there's no visible view in the
// selector; this means we can now safely set the full slide for
// the next page, since slideIn or slideOut might have been called,
- // changing the visiblity
+ // changing the visibility
this.remove_transition('@layout.slide-x');
this.layout.slide_x = this._getSlide();
this._updateTranslation();
// Remove the CSS active state if the user press the button and
// while holding moves to another menu item, so we don't paint all items.
// The correct behaviour would be to set the new item with the CSS
- // active state as well, but button-press-event is not trigered,
+ // active state as well, but button-press-event is not triggered,
// so we should track it in our own, which would involve some work
// in the container
this.remove_style_pseudo_class('active');
# we do no additional supervision of gnome-shell,
# beyond that of wait
# in particular, we don't kill the shell upon
- # receving a KeyboardInterrupt, as we expect to be
+ # receiving a KeyboardInterrupt, as we expect to be
# in the same process group
shell = start_shell(perf_output=perf_output)
shell.wait()
* meta_plugin_manager_set_plugin_type(), Mutter will call the vfuncs of the
* plugin at the appropriate time.
*
- * The funcions in in GnomeShellPlugin are all just stubs, which just call the
+ * The functions in in GnomeShellPlugin are all just stubs, which just call the
* similar methods in GnomeShellWm.
*/
* dialog
* @SHELL_ACTION_MODE_LOGIN_SCREEN: allow action in the login screen
* @SHELL_ACTION_MODE_SYSTEM_MODAL: allow action when a system modal
- * dialog (e.g. authentification or session dialogs) is open
+ * dialog (e.g. authentication or session dialogs) is open
* @SHELL_ACTION_MODE_LOOKING_GLASS: allow action in looking glass
* @SHELL_ACTION_MODE_POPUP: allow action while a shell menu is open
* @SHELL_ACTION_MODE_ALL: always allow action
* shell_app_is_window_backed:
*
* A window backed application is one which represents just an open
- * window, i.e. there's no .desktop file assocation, so we don't know
+ * window, i.e. there's no .desktop file association, so we don't know
* how to launch it again.
*/
gboolean
* @short_description: Blur effect for actors
*
* #ShellBlurEffect is a moderately fast gaussian blur implementation. It also has
- * an optional brighness property.
+ * an optional brightness property.
*
* # Modes
*
object = parent_class->constructor (gtype, n_properties, properties);
/* Setting the resize mode to immediate means that calling queue_resize()
- * on a widget within the window will immmediately call check_resize()
+ * on a widget within the window will immediately call check_resize()
* to be called, instead of having it queued to an idle. From our perspective,
* this is ideal since we just are going to queue a resize to Clutter's
* idle resize anyways.
* overview mode or the "looking glass" debug overlay, that block
* application and normal key shortcuts.
*
- * Returns: %TRUE if we succesfully entered the mode. %FALSE if we couldn't
+ * Returns: %TRUE if we successfully entered the mode. %FALSE if we couldn't
* enter the mode. Failure may occur because an application has the pointer
* or keyboard grabbed, because Mutter is in a mode itself like moving a
* window or alt-Tab window selection, or because shell_global_begin_modal()
- * was previouly called.
+ * was previously called.
*/
gboolean
shell_global_begin_modal (ShellGlobal *global,
* @hook: where to insert the code
* @declarations: GLSL declarations
* @code: GLSL code
- * @is_replace: wheter Cogl code should be replaced by the custom shader
+ * @is_replace: whether Cogl code should be replaced by the custom shader
*
* Adds a GLSL snippet to the pipeline used for drawing the effect texture.
* See #CoglSnippet for details.
/* This is a dummy class; we would like to be able to subclass the
* object from JS but we can't yet; the default GMountOperation impl
* automatically calls g_mount_operation_reply(UNHANDLED) after an idle,
- * in interactive methods. We want to handle the reply outselves
+ * in interactive methods. We want to handle the reply ourselves
* instead, so we just override the default methods with empty ones,
* except for ask-password, as we don't want to handle that.
*
* with each element being a dictionary of the form:
*
* { name: <name of event>,
- * description: <descrition of string,
+ * description: <description of string,
* statistic: true } (only for statistics)
*
* Return value: %TRUE if the dump succeeded. %FALSE if an IO error occurred
/**
* CRAdditionalSel:
*
- * #CRAdditionalSel abstracts an additionnal selector.
+ * #CRAdditionalSel abstracts an additional selector.
* An additional selector is the selector part
* that comes after the combination of type selectors.
* It can be either "a class selector (the .class part),
*
* Appends an attribute selector to the current list of
* attribute selectors represented by a_this.
- * Returns CR_OK upon successfull completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_attr_sel_append_attr_sel (CRAttrSel * a_this, CRAttrSel * a_attr_sel)
*
*Prepends an attribute selector to the list of
*attributes selector represented by a_this.
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_attr_sel_prepend_attr_sel (CRAttrSel * a_this,
*should call their ref/unref method instead if it wants
*
*Returns the newly built instance of CRCascade or NULL if
- *an error arose during constrution.
+ *an error arose during construction.
*/
CRCascade *
cr_cascade_new (CRStyleSheet * a_author_sheet,
*
*Sets a stylesheet in the cascade
*
- *Returns CR_OK upon successfull completion, an error
+ *Returns CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
*@a_decls: the declaration to unlink.
*
*Unlinks the declaration from the declaration list.
- *case of a successfull completion, NULL otherwise.
+ *case of a successful completion, NULL otherwise.
*
*Returns a pointer to the unlinked declaration in
*/
*
*The definition of the CRDocHandler class.
*Contains methods to instantiate, destroy,
- *and initialyze instances of #CRDocHandler
+ *and initialize instances of #CRDocHandler
*to custom values.
*/
*Gets the private parsing context associated to the document handler
*The private parsing context is used by libcroco only.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_doc_handler_get_ctxt (CRDocHandler const * a_this, gpointer * a_ctxt)
*
*Sets the private parsing context.
*This is used by libcroco only.
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_doc_handler_set_ctxt (CRDocHandler * a_this, gpointer a_ctxt)
*Gets the private parsing result.
*The private parsing result is used by libcroco only.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_doc_handler_get_result (CRDocHandler const * a_this, gpointer * a_result)
*Sets the private parsing context.
*This is used by libcroco only.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_doc_handler_set_result (CRDocHandler * a_this, gpointer a_result)
*test handlers. This is expected to change in a
*near future, when the libcroco gets a bit debugged.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_doc_handler_set_default_sac_handler (CRDocHandler * a_this)
/**
* cr_doc_handler_unref:
- *@a_this: the currrent instance of #CRDocHandler.
+ *@a_this: the current instance of #CRDocHandler.
*
*Decreases the ref count of the current instance of #CRDocHandler.
*If the ref count reaches '0' then, destroys the instance.
*Given an encoding name (called an alias name)
*the function returns the matching encoding type.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_enc_handler_resolve_enc_alias (const guchar * a_alias_name,
*
*Converts a raw input buffer into an utf8 buffer.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_enc_handler_convert_input (CREncHandler * a_this,
/**
* cr_font_family_to_string:
* @a_this: the current instance of #CRFontFamily.
- * @a_walk_font_family_list: wether the serialize the entire list.
+ * @a_walk_font_family_list: whether the serialize the entire list.
*
* Returns the seriliazed font family. The caller has to free it using
* g_free().
* @a_this: the current instance of #CRFontFamily.
* @a_name: the new name
*
- * Returns CR_OK upon sucessful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_font_family_set_name (CRFontFamily * a_this, guchar * a_name)
* cr_font_family_destroy:
* @a_this: the current instance of #CRFontFamily.
*
- * Returns CR_OK upon sucessful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_font_family_destroy (CRFontFamily * a_this)
* @a_this: the current instance of #CRFontSize.
* @a_predefined: what to set.
*
- * Returns CR_OK upon sucessful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_font_size_set_predefined_absolute_font_size (CRFontSize *a_this,
* @a_num_type: the type of number to set.
* @a_value: the actual value to set.
*
- * Returns CR_OK upon succesful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_font_size_set_absolute_font_size (CRFontSize *a_this,
* cr_font_size_set_to_inherit:
* @a_this: the current instance of #CRFontSize
*
- * Returns CR_OK upon succesful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_font_size_set_to_inherit (CRFontSize *a_this)
*the current instance has reached the end of its input buffer,
*FALSE otherwise.
*
- *Tests wether the current instance of
+ *Tests whether the current instance of
*#CRInput has reached its input buffer.
*
* Returns CR_OK upon successful completion, an error code otherwise.
*@a_this: the this pointer of the current instance of #CRInput.
*@a_char: the character to consume.
*@a_nb_char: in/out parameter. The number of characters to consume.
- *If set to a negative value, the function will consume all the occurences
+ *If set to a negative value, the function will consume all the occurrences
*of a_char found.
*After return, if the return value equals CR_OK, this variable contains
*the number of characters actually consumed.
*
- *Consumes up to a_nb_char occurences of the next contiguous characters
+ *Consumes up to a_nb_char occurrences of the next contiguous characters
*which equal a_char. Note that the next character of the input stream
**MUST* equal a_char to trigger the consumption, or else, the error
*code CR_PARSING_ERROR is returned.
*instance of #CRNum
*@a_type: the new type of #CRNum.
*
- * Returns CR_OK upon succesful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_num_set (CRNum * a_this, gdouble a_val, enum CRNumType a_type)
}
/*
- *initialyze here the sac handler.
+ *initialize here the sac handler.
*/
sac_handler->start_document = start_document;
sac_handler->end_document = end_document;
g_return_if_fail (str);
}
- /*instanciates a new declaration */
+ /*instantiates a new declaration */
decl = cr_declaration_new (ctxt->cur_stmt, str, a_expression);
g_return_if_fail (decl);
str = NULL;
*
*Parses the content of an in memory buffer.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_om_parser_parse_buf (CROMParser * a_this,
*
*The simpler way to parse an in memory css2 buffer.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_om_parser_simply_parse_buf (const guchar * a_buf,
* cr_om_parser_parse_file:
*@a_this: the current instance of the cssom parser.
*@a_file_uri: the uri of the file.
- *(only local file paths are suppported so far)
+ *(only local file paths are supported so far)
*@a_enc: the encoding of the file.
*@a_result: out parameter. A pointer
*the build css object model.
*Parses a css2 stylesheet contained
*in a file.
*
- * Returns CR_OK upon succesful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_om_parser_parse_file (CROMParser * a_this,
*
*The simpler method to parse a css2 file.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*Note that this method uses cr_om_parser_parse_file() so both methods
*have the same return values.
*/
*that css UA must comply with two syntaxes.
*
*1/the specific syntax that defines the css language
- *for a given level of specificatin (e.g css2 syntax
+ *for a given level of specification (e.g css2 syntax
*defined in appendix D.1 of the css2 spec)
*
*2/the core (general) syntax that is there to allow
*@a_is_exception: in case of error, if is TRUE, the status
*is set to CR_PARSING_ERROR before goto error. If is false, the
*real low level status is kept and will be returned by the
- *upper level function that called this macro. Usally,this must
+ *upper level function that called this macro. Usually,this must
*be set to FALSE.
*
*same as CHECK_PARSING_STATUS() but this one pushes an error
*Reads the next char from the input stream of the current parser.
*In case of error, jumps to the "error:" label located in the
*function where this macro is called.
- *@param a_this the curent instance of #CRParser
+ *@param a_this the current instance of #CRParser
*@param to_char a pointer to the guint32 char where to store
*the character read.
*/
*@param a_this the current instance of #CRParser.
*@param a_msg the error message.
*@param a_status the error status.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_push_error (CRParser * a_this,
*@param a_this the current instance of #CRParser.
*@param a_clear_errs whether to clear the error stack
*after the dump or not.
- *@return CR_OK upon successfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
static enum CRStatus
*Same as cr_parser_try_to_skip_spaces() but this one skips
*spaces and comments.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_try_to_skip_spaces_and_comments (CRParser * a_this)
*in chapter 4.1 in the css2 spec.
*at-rule : ATKEYWORD S* any* [ block | ';' S* ];
*@param a_this the current instance of #CRParser.
- *@return CR_OK upon successfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
static enum CRStatus
*4.1 of the css2 spec.
*ruleset ::= selector? '{' S* declaration? [ ';' S* declaration? ]* '}' S*;
*@param a_this the current instance of #CRParser.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_ruleset_core (CRParser * a_this)
*grammar.
*selector : any+;
*@param a_this the current instance of #CRParser.
- *@return CR_OK upon successfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
static enum CRStatus
*in chapter 4.1.
*value ::= [ any | block | ATKEYWORD S* ]+;
*@param a_this the current instance of #CRParser.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_value_core (CRParser * a_this)
*
*@param a_this the current instance of #CRParser.
*@param n_calls used to limit recursion depth
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_any_core (CRParser * a_this,
*@param a_this the "this pointer" of the current instance of
*#CRParser .
*@param a_sel out parameter. The successfully parsed attribute selector.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_attribute_selector (CRParser * a_this,
*new instance of GString and set it content to the parsed property.
*If not, the property is just appended to a_property's previous content.
*In both cases, it is up to the caller to free a_property.
- *@return CR_OK upon successfull completion, CR_PARSING_ERROR if the
+ *@return CR_OK upon successful completion, CR_PARSING_ERROR if the
*next construction was not a "property", or an error code.
*/
static enum CRStatus
*
*TODO: handle parsing of 'RGB'
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_term (CRParser * a_this, CRTerm ** a_term)
*and where pseudo is:
*pseudo ::= ':' [ IDENT | FUNCTION S* IDENT S* ')' ]
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_simple_selector (CRParser * a_this, CRSimpleSel ** a_sel)
* cr_parser_parse_simple_sels:
*@a_this: the this pointer of the current instance of #CRParser.
*@a_start: a pointer to the
- *first chararcter of the successfully parsed
+ *first character of the successfully parsed
*string.
*@a_end: a pointer to the last character of the successfully parsed
*string.
*Parses a "selector" as defined by the css2 spec in appendix D.1:
*selector ::= simple_selector [ combinator simple_selector ]*
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_simple_sels (CRParser * a_this,
*function ::= FUNCTION S* expr ')' S*
*FUNCTION ::= ident'('
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_function (CRParser * a_this,
* URI ::= url\({w}{string}{w}\)
* |url\({w}([!#$%&*-~]|{nonascii}|{escape})*{w}\)
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_uri (CRParser * a_this, CRString ** a_str)
/**
* cr_parser_parse_string:
*@a_this: the current instance of #CRParser.
- *@a_start: out parameter. Upon successfull completion,
+ *@a_start: out parameter. Upon successful completion,
*points to the beginning of the string, points to an undefined value
*otherwise.
- *@a_end: out parameter. Upon successfull completion, points to
+ *@a_end: out parameter. Upon successful completion, points to
*the beginning of the string, points to an undefined value otherwise.
*
*Parses a string type as defined in css spec [4.1.1]:
*string1 ::= \"([\t !#$%&(-~]|\\{nl}|\'|{nonascii}|{escape})*\"
*string2 ::= \'([\t !#$%&(-~]|\\{nl}|\"|{nonascii}|{escape})*\'
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_string (CRParser * a_this, CRString ** a_str)
*the function just appends the parsed string to the one passed.
*In both cases it is up to the caller to free *a_str.
*
- *@return CR_OK upon successfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
static enum CRStatus
*@param a_end out parameter. A pointer to the first character of
*the successfully parsed string.
*
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_parser_parse_stylesheet (CRParser * a_this)
*of #CRParser. If set to FALSE, it is up to the caller to
*eventually free it.
*
- *Instanciates a new parser from a memory buffer.
+ *Instantiates a new parser from a memory buffer.
*
*Returns the newly built parser, or NULL if an error arises.
*/
*
*Sets a SAC document handler to the parser.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_set_sac_handler (CRParser * a_this, CRDocHandler * a_handler)
*
*Gets the SAC document handler.
*
- *Returns CR_OK upon successfull completion, an error code
+ *Returns CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
*Sets the SAC handler associated to the current instance
*of #CRParser to the default SAC handler.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_set_default_sac_handler (CRParser * a_this)
* @a_this: the current instance of #CRParser.
* @a_use_core_grammar: where to parse against the css core grammar.
*
- * Returns CR_OK upon succesful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_set_use_core_grammar (CRParser * a_this,
/**
* cr_parser_get_use_core_grammar:
* @a_this: the current instance of #CRParser.
- * @a_use_core_grammar: wether to use the core grammar or not.
+ * @a_use_core_grammar: whether to use the core grammar or not.
*
- * Returns CR_OK upon succesful completion, an error code otherwise.
+ * Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_get_use_core_grammar (CRParser const * a_this,
*
*Parses a the given in parameter.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_file (CRParser * a_this,
*Parses a "declaration" as defined by the css2 spec in appendix D.1:
*declaration ::= [property ':' S* expr prio?]?
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_declaration (CRParser * a_this,
*chapter 4.1 of the css2 spec.
*statement : ruleset | at-rule;
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_statement_core (CRParser * a_this)
*See the documentation of #CRDocHandler (the SAC handler) to know
*when which SAC handler is called.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_ruleset (CRParser * a_this)
*import ::=
*\@import [STRING|URI] S* [ medium [ ',' S* medium]* ]? ';' S*
*
- *Returns CR_OK upon sucessfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_import (CRParser * a_this,
*will corrupt the memory and lead to hard to debug
*random crashes.
*This is where C++ and its compile time
- *type checking mecanism (through STL containers) would
+ *type checking mechanism (through STL containers) would
*have prevented us to go through this hassle.
*/
for (cur = *a_media_list; cur; cur = cur->next) {
*to notify media productions. See #CRDocHandler to know the callback called
*during \@media parsing.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_media (CRParser * a_this)
*encounters a construction that must
*be reported to the calling application.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_page (CRParser * a_this)
*set to NULL.
*@a_charset_sym_location: the parsing location of the charset rule
*
- *Parses a charset declaration as defined implictly by the css2 spec in
+ *Parses a charset declaration as defined implicitly by the css2 spec in
*appendix D.1:
*charset ::= CHARSET_SYM S* STRING S* ';'
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_charset (CRParser * a_this, CRString ** a_value,
*
*This function will call SAC handlers whenever it is necessary.
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse_font_face (CRParser * a_this)
*input previously associated to the current instance of
*#CRParser.
*
- *Returns CR_OK upon succesful completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parser_parse (CRParser * a_this)
*
*Getter of the parser's underlying tokenizer
*
- *Returns CR_OK upon succesful completion, an error code
+ *Returns CR_OK upon successful completion, an error code
*otherwise
*/
enum CRStatus
*
*Gets the current parsing location.
*
- *Returns CR_OK upon succesful completion, an error code
+ *Returns CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
/**
* cr_parsing_location_new:
- *Instanciates a new parsing location.
+ *Instantiates a new parsing location.
*
- *Returns the newly instanciated #CRParsingLocation.
+ *Returns the newly instantiated #CRParsingLocation.
*Must be freed by cr_parsing_location_destroy()
*/
CRParsingLocation *
*
*Initializes the an instance of #CRparsingLocation.
*
- *Returns CR_OK upon succesful completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_parsing_location_init (CRParsingLocation *a_this)
*
*Copies an instance of CRParsingLocation into another one.
*
- *Returns CR_OK upon succesful completion, an error code
+ *Returns CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
*@a_prop_name: property name to append
*@a_decl: the property value to append.
*
- *Prepends a propertie to a list of properties
+ *Prepends a property to a list of properties
*
*Returns the new property list.
*/
*@a_this: the this pointer of the current instance of #CRSimpleSel.
*@a_sel: the simple selector to append.
*
- *Returns: the new list upon successfull completion, an error code otherwise.
+ *Returns: the new list upon successful completion, an error code otherwise.
*/
CRSimpleSel *
cr_simple_sel_append_simple_sel (CRSimpleSel * a_this, CRSimpleSel * a_sel)
*
*Prepends a simple selector to the current list of simple selectors.
*
- *Returns the new list upon successfull completion, an error code otherwise.
+ *Returns the new list upon successful completion, an error code otherwise.
*/
CRSimpleSel *
cr_simple_sel_prepend_simple_sel (CRSimpleSel * a_this, CRSimpleSel * a_sel)
*Dumps the selector to a file.
*TODO: add the support of unicode in the dump.
*
- *Returns CR_OK upon successfull completion, an error code
+ *Returns CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
*Computes the selector (combinator separated list of simple selectors)
*as defined in the css2 spec in chapter 6.4.3
*
- *Returns CR_OK upon successfull completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_simple_sel_compute_specificity (CRSimpleSel * a_this)
*then been called 'universal selector')
*
*2/An additional selector that "specializes" the preceding type or
- *universal selector. The additionnal selector can be either
+ *universal selector. The additional selector can be either
*an id selector, or a class selector, or an attribute selector.
*/
struct _CRSimpleSel
*@a_buf: the buffer to parse.
*@a_enc: the character encoding of a_buf.
*
- *Parses a buffer that contains a ruleset statement an instanciates
+ *Parses a buffer that contains a ruleset statement an instantiates
*a #CRStatement of type RULESET_STMT.
*
*Returns the newly built instance of #CRStatement in case of successful parsing,
*in the \@media rule.
*@a_media: the media string list. A list of GString pointers.
*
- *Instanciates an instance of #CRStatement of type
+ *Instantiates an instance of #CRStatement of type
*AT_MEDIA_RULE_STMT (\@media ruleset).
*
*/
*@a_encoding: the encoding of a_buf.
*
*Parses a buffer that contains an "\@import" rule and
- *instanciate a #CRStatement of type AT_IMPORT_RULE_STMT
+ *instantiate a #CRStatement of type AT_IMPORT_RULE_STMT
*
*Returns the newly built instance of #CRStatement in case of
*a successful parsing, NULL otherwise.
*@a_this: the current statement.
*@a_declaration: the declaration to append.
*
- *Returns CR_OK upon sucessful completion, an error code
+ *Returns CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
*only if the function returns CR_OK.
*
*Gets the stylesheet contained by the \@import rule statement.
- *Returns CR_OK upon sucessful completion, an error code otherwise.
+ *Returns CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_statement_at_import_rule_get_imported_sheet (CRStatement * a_this,
CRString * charset ;
};
-/**The abstaction of the \@font-face rule.*/
+/**The abstraction of the \@font-face rule.*/
typedef struct _CRAtFontFaceRule CRAtFontFaceRule ;
struct _CRAtFontFaceRule
{
#include "cr-string.h"
/**
- *Instanciates a #CRString
- *@return the newly instanciated #CRString
+ *Instantiates a #CRString
+ *@return the newly instantiated #CRString
*Must be freed with cr_string_destroy().
*/
CRString *
}
/**
- *Instanciate a string and initialise it to
+ *Instantiate a string and initialise it to
*a_string.
*@param a_string the initial string
- *@return the newly instanciated string.
+ *@return the newly instantiated string.
*/
CRString *
cr_string_new_from_string (const gchar * a_string)
}
/**
- *Instanciates a #CRString from an instance of GString.
+ *Instantiates a #CRString from an instance of GString.
*@param a_string the input string that will be copied into
- *the newly instanciated #CRString
- *@return the newly instanciated #CRString.
+ *the newly instantiated #CRString
+ *@return the newly instantiated #CRString.
*/
CRString *
cr_string_new_from_gstring (GString const *a_string)
gpointer app_data ;
/**
- *the reference count of this insance
+ *the reference count of this instance
*Please, don't never ever modify it
*directly. Use cr_stylesheet_ref()
*and cr_stylesheet_unref() instead.
}
/**
- *Instanciate a #CRTerm.
+ *Instantiate a #CRTerm.
*@return the newly build instance
*of #CRTerm.
*/
}
/**
- *Parses an expresion as defined by the css2 spec
+ *Parses an expression as defined by the css2 spec
*and builds the expression as a list of terms.
*@param a_buf the buffer to parse.
*@return a pointer to the first term of the expression or
*Reads the next char from the input stream of the current parser.
*In case of error, jumps to the "error:" label located in the
*function where this macro is called.
- *@param parser the curent instance of #CRTknzr
+ *@param parser the current instance of #CRTknzr
*@param to_char a pointer to the guint32 char where to store
*the character read.
*/
* w ::= [ \t\r\n\f]*
*
*@param a_this the current instance of #CRTknzr.
- *@param a_start out param. Upon successfull completion, points
+ *@param a_start out param. Upon successful completion, points
*to the beginning of the parsed white space, points to NULL otherwise.
*Can also point to NULL is there is no white space actually.
- *@param a_end out param. Upon successfull completion, points
+ *@param a_end out param. Upon successful completion, points
*to the end of the parsed white space, points to NULL otherwise.
*Can also point to NULL is there is no white space actually.
*/
*parsed string.
*@param a_end a pointer to the last character of the successfully parsed
*string.
- *@result CR_OK uppon successfull completion, an error code otherwise.
+ *@result CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_parse_nl (CRTknzr * a_this,
*In any cases, it stops when it encounters a non white space character.
*
*@param a_this the current instance of #CRTknzr.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_try_to_skip_spaces (CRTknzr * a_this)
*the caller.
*@param a_end out parameter. A pointer to the last character
*of the unicode escape sequence. Must *NOT* be deleted by the caller.
- *@return CR_OK if parsing succeded, an error code otherwise.
+ *@return CR_OK if parsing succeeded, an error code otherwise.
*Error code can be either CR_PARSING_ERROR if the string
*parsed just doesn't
*respect the production or another error if a
*string2 ::= \'([\t !#$%&(-~]|\\{nl}|\"|{nonascii}|{escape})*\'
*
*@param a_this the current instance of #CRTknzr.
- *@param a_start out parameter. Upon successfull completion,
+ *@param a_start out parameter. Upon successful completion,
*points to the beginning of the string, points to an undefined value
*otherwise.
- *@param a_end out parameter. Upon successfull completion, points to
+ *@param a_end out parameter. Upon successful completion, points to
*the beginning of the string, points to an undefined value otherwise.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_parse_string (CRTknzr * a_this, CRString ** a_str)
*@param a_end out param. A pointer to the ending point of the
*token.
*@param a_char out param. The actual parsed nmchar.
- *@return CR_OK upon successfull completion,
+ *@return CR_OK upon successful completion,
*an error code otherwise.
*/
static enum CRStatus
*@param a_end out param. A pointer to the ending point of the
*token.
*@param a_char out param. The actual parsed nmchar.
- *@return CR_OK upon successfull completion,
+ *@return CR_OK upon successful completion,
*an error code otherwise.
*/
static enum CRStatus
*the function just appends the parsed string to the one passed.
*In both cases it is up to the caller to free *a_str.
*
- *@return CR_OK upon successfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
static enum CRStatus
*of CRString. If not, it just appends the parsed name to the passed *a_str.
*In both cases, it is up to the caller to free *a_str.
*
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_parse_name (CRTknzr * a_this,
*
*@param a_this the current instance of #CRTknzr.
*@param a_str the successfully parsed url.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_parse_uri (CRTknzr * a_this,
*
*@param a_this the "this pointer" of the current instance of
*@param a_rgb out parameter the parsed rgb.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_parse_rgb (CRTknzr * a_this, CRRgb ** a_rgb)
*the parsed atkeyword to the end of *a_str. In both cases it is up to
*the caller to free *a_str.
*
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
static enum CRStatus
cr_tknzr_parse_atkeyword (CRTknzr * a_this,
*[0-9]+|[0-9]*\.[0-9]+
*@param a_this the current instance of #CRTknzr.
*@param a_num out parameter. The parsed number.
- *@return CR_OK upon successfull completion,
+ *@return CR_OK upon successful completion,
*an error code otherwise.
*
*The CSS specification says that numbers may be
- *preceeded by '+' or '-' to indicate the sign.
+ *preceded by '+' or '-' to indicate the sign.
*Technically, the "num" construction as defined
*by the tokenizer doesn't allow this, but we parse
*it here for simplicity.
*#CRParser.
*@param a_byte out parameter the place where to store the byte
*read.
- *@return CR_OK upon successfull completion, an error
+ *@return CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
*Reads the next char from the parser input stream.
*@param a_this the current instance of #CRTknzr.
*@param a_char out parameter. The read char.
- *@return CR_OK upon successfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
*To "peek a char" means reads the next char without consuming it.
*Subsequent calls to this function return the same char.
*@param a_this the current instance of #CRTknzr.
- *@param a_char out parameter. The peeked char uppon successfull completion.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@param a_char out parameter. The peeked char upon successful completion.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_tknzr_peek_char (CRTknzr * a_this, guint32 * a_char)
}
/**
- *Peeks a byte ahead at a given postion in the parser input stream.
+ *Peeks a byte ahead at a given position in the parser input stream.
*@param a_this the current instance of #CRTknzr.
*@param a_offset the offset of the peeked byte starting from the current
*byte in the parser input stream.
*@param a_byte out parameter. The peeked byte upon
- *successfull completion.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *successful completion.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_tknzr_peek_byte (CRTknzr * a_this, gulong a_offset, guchar * a_byte)
*@param a_tk out parameter. The returned token.
*for the sake of mem leak avoidance, *a_tk must
*be NULL.
- *@param CR_OK upon successfull completion, an error code
+ *@param CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
status = cr_token_set_function
(token, str);
CHECK_PARSING_STATUS (status, TRUE);
- /*ownership is transfered
+ /*ownership is transferred
*to token by cr_token_set_function.
*/
if (str) {
*Sets the type of curren instance of
*#CRToken to 'S_TK' (S in the css2 spec)
*@param a_this the current instance of #CRToken.
- *@return CR_OK upon successfull completion, an error
+ *@return CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
*Sets the type of the current instance of
*#CRToken to 'CDO_TK' (CDO as said by the css2 spec)
*@param a_this the current instance of #CRToken.
- *@return CR_OK upon successfull completion, an error
+ *@return CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
*Sets the type of the current token to
*CDC_TK (CDC as said by the css2 spec).
*@param a_this the current instance of #CRToken.
- *@return CR_OK upon successfull completion, an error
+ *@return CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
*Sets the type of the current instance of
*#CRToken to INCLUDES_TK (INCLUDES as said by the css2 spec).
*@param a_this the current instance of #CRToken.
- *@return CR_OK upon successfull completion, an error
+ *@return CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
*Sets the type of the current instance of
*#CRToken to DASHMATCH_TK (DASHMATCH as said by the css2 spec).
*@param a_this the current instance of #CRToken.
- *@return CR_OK upon successfull completion, an error
+ *@return CR_OK upon successful completion, an error
*code otherwise.
*/
enum CRStatus
****************************/
/*
- *Here is the correspondance between the ucs-4 charactere codes
- *and there matching utf-8 encoding pattern as dscribed by RFC 2279:
+ *Here is the correspondence between the ucs-4 charactere codes
+ *and there matching utf-8 encoding pattern as described by RFC 2279:
*
*UCS-4 range (hex.) UTF-8 octet sequence (binary)
*------------------ -----------------------------
*Given an utf8 string buffer, calculates
*the length of this string if it was encoded
*in ucs4.
- *@param a_in_start a pointer to the begining of
+ *@param a_in_start a pointer to the beginning of
*the input utf8 string.
*@param a_in_end a pointre to the end of the input
*utf8 string (points to the last byte of the buffer)
*@param a_len out parameter the calculated length.
- *@return CR_OK upon succesfull completion, an error code
+ *@return CR_OK upon successful completion, an error code
*otherwise.
*/
enum CRStatus
*buffer.
*@param a_in_end a pointer to the end of the input buffer.
*@param a_len out parameter. The computed length.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_ucs4_str_len_as_utf8 (const guint32 * a_in_start,
*buffer.
*@param a_in_end a pointer to the end of the input buffer.
*@param a_len out parameter. The computed length.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_ucs1_str_len_as_utf8 (const guchar * a_in_start,
*If this size is actually smaller than the real needed size, the function
*just converts what it can and returns a success status. After return,
*this param points to the actual number of characters decoded.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_utf8_to_ucs4 (const guchar * a_in,
*@param a_out output parameter. The resulting read char.
*@param a_consumed the number of the bytes consumed to
*decode the returned character code.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_read_char_from_utf8_buf (const guchar * a_in,
*@param a_in the input string to convert.
*@param a_in_len in/out parameter. The length of the input
*string. After return, points to the actual number of bytes
- *consumed. This can be usefull to debug the input stream in case
+ *consumed. This can be useful to debug the input stream in case
*of encoding error.
*@param a_out out parameter. Points to the output string. It is allocated
*by this function and must be freed by the caller.
*@param a_out_len out parameter. The length of the output string.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*
*/
enum CRStatus
*If this size is actually smaller than the real needed size, the function
*just converts what it can and returns a success status. After return,
*this param points to the actual number of bytes in the buffer.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_ucs4_to_utf8 (const guint32 * a_in,
*@param a_in the input string to convert.
*@param a_in_len in/out parameter. The length of the input
*string. After return, points to the actual number of characters
- *consumed. This can be usefull to debug the input string in case
+ *consumed. This can be useful to debug the input string in case
*of encoding error.
*@param a_out out parameter. Points to the output string. It is allocated
*by this function and must be freed by the caller.
*@param a_out_len out parameter. The length (in bytes) of the output string.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_ucs4_str_to_utf8 (const guint32 * a_in,
*If the output buffer size is shorter than the actual needed size,
*this function just convert what it can.
*
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*
*/
enum CRStatus
*@param a_in_end the end of the input string to convert.
*@param a_out out parameter. The converted string.
*@param a_out out parameter. The length of the converted string.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*
*/
enum CRStatus
*@param a_out out parameter. Points to the resulting buffer.
*Must be allocated by the caller. If the size of a_out is shorter
*than its required size, this function converts what it can and return
- *a successfull status.
+ *a successful status.
*
*@param a_out_len in/out parameter. The size of the output buffer.
*After return, points to the number of bytes consumed even in case of
*encoding error.
*
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*/
enum CRStatus
cr_utils_utf8_to_ucs1 (const guchar * a_in,
*@param a_out out parameter. The resulting converted ucs4 buffer.
*Must be freed by the caller.
*@param a_out_len out parameter. The length of the converted buffer.
- *@return CR_OK upon successfull completion, an error code otherwise.
+ *@return CR_OK upon successful completion, an error code otherwise.
*Note that out parameters are valid if and only if this function
*returns CR_OK.
*/
g_object_notify_by_pspec (G_OBJECT (adjustment), props[PROP_PAGE_SIZE]);
- /* Well explicitely clamp after construction. */
+ /* We'll explicitly clamp after construction. */
if (!priv->is_constructing)
st_adjustment_clamp_page (adjustment, priv->lower, priv->upper);
* @name: a unique name for the transition
* @transition: a #ClutterTransition
*
- * Add a #ClutterTransition for the adjustment. If the transiton stops, it will
+ * Add a #ClutterTransition for the adjustment. If the transition stops, it will
* be automatically removed if #ClutterTransition:remove-on-complete is %TRUE.
*/
void
/**
* st_adjusmtent_remove_transition:
- * @adjusment: a #StAdjustment
+ * @adjustment: a #StAdjustment
* @name: the name of the transition to remove
*
* Remove a #ClutterTransition previously added by st_adjustment_add_transtion()
* st_clipboard_get_text:
* @clipboard: A #StCliboard
* @type: The type of clipboard data you want
- * @callback: (scope async): function to be called when the text is retreived
+ * @callback: (scope async): function to be called when the text is retrieved
* @user_data: data to be passed to the callback
*
* Request the data from the clipboard in text form. @callback is executed
- * when the data is retreived.
+ * when the data is retrieved.
*/
void
st_clipboard_get_text (StClipboard *clipboard,
* @area: the #StDrawingArea
*
* Gets the Cairo context to paint to. This function must only be called
- * from a signal hander or virtual function for the #StDrawingArea::repaint
+ * from a signal handler or virtual function for the #StDrawingArea::repaint
* signal.
*
* JavaScript code must call the special dispose function before returning from
*
* Gets the size of the cairo surface being painted to, which is equal
* to the size of the content area of the widget. This function must
- * only be called from a signal hander for the #StDrawingArea::repaint signal.
+ * only be called from a signal handler for the #StDrawingArea::repaint signal.
*/
void
st_drawing_area_get_surface_size (StDrawingArea *area,
/**
* StIcon:icon-size:
*
- * The size of the icon, if greater than `0`. Other the icon sise is derived
+ * The size of the icon, if greater than `0`. Other the icon size is derived
* from the current style.
*/
props[PROP_ICON_SIZE] =
* inside the #StAdjustment.
*
* The second simplification that we make that allows us to implement
- * a straighforward height-for-width negotiation without multiple
+ * a straightforward height-for-width negotiation without multiple
* allocate passes is that when the scrollbar policy is
* AUTO, we always reserve space for the scrollbar in the
* reported minimum and natural size.
/**
* st_scroll_view_update_fade_effect:
* @scroll: a #StScrollView
- * @vfade_offset: The length of the veritcal fade effect, in pixels.
+ * @vfade_offset: The length of the vertical fade effect, in pixels.
* @hfade_offset: The length of the horizontal fade effect, in pixels.
*
* Sets the height of the fade area area in pixels. A value of 0
clutter_actor_allocate (priv->hscroll, &child_box);
/* In case the scrollbar policy is NEVER or EXTERNAL or scrollbars
- * should be overlayed, we don't trim the content box allocation by
+ * should be overlaid, we don't trim the content box allocation by
* the scrollbar size.
* Fold this into the scrollbar sizes to simplify the rest of the
* computations.
* for setting the adjustments. The parent container then sets the adjustments
* back to %NULL when the scrollable is removed.
*
- * For #StScrollable supporting height-for-width size negotation, size
- * negotation works as follows:
+ * For #StScrollable supporting height-for-width size negotiation, size
+ * negotiation works as follows:
*
* In response to get_preferred_width(), the scrollable should report
* the minimum width at which horizontal scrolling is needed for the
/* Inset shadows are drawn below the border, so returning
* the original box is not actually correct; still, it's
- * good enough for the purpose of determing additional space
+ * good enough for the purpose of determining additional space
* required outside the actor box.
*/
if (shadow->inset)
* @pixbuf_loader: #GdkPixbufLoader loading the image
* @width: the original width of the image
* @height: the original height of the image
- * @data: pointer to the #Dimensions sructure containing available width and height for the image,
+ * @data: pointer to the #Dimensions structure containing available width and height for the image,
* available width or height can be -1 if the dimension is not limited
*
* Private function.
gicon_string = g_icon_to_string (icon);
/* A return value of NULL indicates that the icon can not be serialized,
* so don't have a unique identifier for it as a cache key, and thus can't
- * be cached. If it is cachable, we hardcode a policy of FOREVER here for
+ * be cached. If it is cacheable, we hardcode a policy of FOREVER here for
* now; we should actually blow this away on icon theme changes probably */
policy = gicon_string != NULL ? ST_TEXTURE_CACHE_POLICY_FOREVER
: ST_TEXTURE_CACHE_POLICY_NONE;
*
* Sets the default set of theme stylesheets for the context. This theme will
* be used for the root node and for nodes descending from it, unless some other
- * style is explicitely specified.
+ * style is explicitly specified.
*/
void
st_theme_context_set_theme (StThemeContext *context,
*
* Sets the default font for the theme context. This is the font that
* is inherited by the root node of the tree of theme nodes. If the
- * font is not overriden, then this font will be used. If the font is
+ * font is not overridden, then this font will be used. If the font is
* partially modified (for example, with 'font-size: 110%'), then that
* modification is based on this font.
*/
rectangles, idx / 8);
#if 0
- /* Visual feedback on shadow's 9-slice and orignal offscreen buffer,
+ /* Visual feedback on shadow's 9-slice and original offscreen buffer,
for debug purposes */
cogl_framebuffer_draw_rectangle (framebuffer, state->box_shadow_pipeline,
xend, yoffset, xend + shadow_width, yoffset + shadow_height);
* st_theme_node_get_element_id:
* @node: a #StThemeNode
*
- * Get the unqiue element ID for @node.
+ * Get the unique element ID for @node.
*
* Returns: (transfer none): the element's ID
*/
* st_theme_node_get_horizontal_padding:
* @node: a #StThemeNode
*
- * Gets the total horizonal padding (left + right padding), in physical pixels.
+ * Gets the total horizontal padding (left + right padding), in physical pixels.
*
- * Returns: the total horizonal padding in physical pixels
+ * Returns: the total horizontal padding in physical pixels
*/
double
st_theme_node_get_horizontal_padding (StThemeNode *node)
for (cur_stmt = a_nodesheet->statements; cur_stmt; cur_stmt = cur_stmt->next)
{
/*
- *initialyze the selector list in which we will
+ *initialize the selector list in which we will
*really perform the search.
*/
sel_list = NULL;
* thread-safety anyways.)
*
* Once we've sorted the properties, the specificity no longer
- * matters and it can be safely overriden.
+ * matters and it can be safely overridden.
*/
cr_simple_sel_compute_specificity (cur_sel->simple_sel);
/* group2 is defined as having a thin black border along the top three
* sides with rounded joins, then a square-joined green border at the
- * botttom
+ * bottom
*/
assert_length ("group2", "border-top-width", 2.,
#if 0
/* This is adapted from code that was commented out in na-tray-manager.c; the
* code in na-tray-manager.c wouldn't have worked reliably, this will. So maybe
- * it can be reenabled. On other hand, things seem to be working fine without
+ * it can be re-enabled. On other hand, things seem to be working fine without
* it.
*
* If reenabling, you need to hook it up in na_tray_child_class_init().
# -*- mode: python -*-
#
-# jhbuildrc for building gnome-shell. Customizations shuld be done in
+# jhbuildrc for building gnome-shell. Customizations should be done in
# ~/.jhbuildrc-custom
#
# Copyright (C) 2008 Red Hat, Inc.
projects / gnome-shell.git / commitdiff